home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbdir15.zip / PCBDIRSZ.DOC < prev    next >
Text File  |  1992-02-14  |  6KB  |  146 lines
  1.                 PCBDIRSZ 'PCBoard DIRectory Statistics'
  2.  
  3.  
  4.                             Version 1.5
  5.                            by Barry Young
  6.                          System Support BBS
  7.                        PCBoard 3-node vrs 14.5a
  8.                     Westminster, CO (303) 469-9359
  9.  
  10.  
  11.      Thank  you  for downloading this file and checking  it  out!
  12. This  program had been designed for my personal use, but  decided
  13. to  make  it a PD 'Public Domain' program for any  PCBoard  14.x+
  14. SysOp  to use. You can use it for your own personal interest,  or    
  15. you  can have the program redirect the output to an  ascii  file,
  16. which could be used as one of your Bulletins on the BBS. It is  a
  17. simple program to use, although it will require creating a simple
  18. configuration program) that will  point to your DIR.LST  and  the
  19. location of your DIRxx files.
  20.  
  21.      The  basic  purpose  of  this  program  is   to   read  your
  22. DIRectories  files  and summarize  the  total number of files and 
  23. the kilobytes used of harddisk space for each DIRectory.  It will
  24. also keep sub-totals as it goes of both  # of files and kilobytes
  25. used. There may be other ways to determine this, but I have found
  26. this program to be invaluable to me by keeping me informed of how
  27. much space is being used on my harddisk.
  28.  
  29. The files included in this ZIP'ped package are:
  30.  
  31.  
  32. PCBDIRSZ.EXE  (main program)
  33. PCBDIRSZ.CFG  (sample configuration file)
  34. PCBDIRSZ.DOC  (this document file that you are reading)
  35. BLT         (sample bulletin created from the program)
  36.  
  37.            _______________To get started:_______________
  38.  
  39.  
  40.      The  PCBDIRSZ.EXE  program  should  either  be  in  your BBS
  41. directory ( \PCB )  or  in  your  computer  PATH.  You will  also
  42. need to create your own PCBDIRSZ.CFG file or modify the  one that
  43. I have provided. This file will contain one or more lines.
  44.  
  45. D:\PCB\GEN\DIR.LST   < required
  46. DIR3                 < optional line to exclude DIR3 from report
  47. DIR18                < optional line to exclude DIR18 from report
  48.  
  49. Here  is an example of how I have  mine  setup.  My BBS system is
  50. on drive  D:  and  the  main PCBOARD directory is \PCB.
  51.  
  52.      I have included  the  one  line   in  your sample (provided)
  53. PCBDIRSZ.CFG  file.  This required line (DIR.LST   including  the
  54. drive\path)  tells  the  program  where  to  find your  DIRectory
  55. .LST file. Any following lines will list the DIRxx of any
  56. DIRectory that you don't want included in the report.
  57. Example:  if 2nd line had DIR18 (no drive or path included), this
  58. would exclude DIR18 from being included in your report. I don't
  59. include DIR0 or PRIVATE DIRectories in the program, since most
  60. SysOps don't want the Private Upload Directory to be listed.
  61.  
  62.      This  file  can be located anywhere, but it must be  in  the
  63. directory  that you are running it from. The simplest way  is  to
  64. have both the files in your \PCB directory. 
  65.  
  66.  
  67.      Normally, you would have this PCBDIRSZ.EXE program  run once
  68. a day.  I have it run during my morning event. It can, however,be
  69. run  as many times as you want. I have incorporated File  Sharing
  70. (read-only, lock-mode),  so  it can  be run  with the other nodes
  71. being used. It  will only  be sharing the DIR.LST and DIRxx files
  72. so it can be run with the other nodes looking at the files.
  73.  
  74.  
  75.      If you want to include the displayed output into a bulletin,
  76. then you will need to redirect the output with the > command when
  77. running the program. I have mine being used as:
  78.  
  79. PCBDIRSZ > D:\PCB\GEN\BLT10
  80.  
  81.  
  82.       That redirects the output automatically to my bulletin #10.
  83.  
  84.  
  85.      I  have  a few other little PCBoard utilities  that  I  have
  86. written, but have not released them to the Public Domain at  this
  87. time. This will be my 2nd released PD program for anyone seeing a
  88. need for it. Since I like to tinker with the programs, there  may
  89. be updated versions of this program. I also ask other people  for
  90. their opinions of it and may make enhancements upon their sugges-
  91. tions.
  92.  
  93.  
  94.      You can find this program, and any possible updates to it on
  95. my board, relocated to Westminster, CO.
  96.  
  97.  
  98.       System Support BBS   (303)-469-9359  SysOp Barry Young
  99.  
  100.  
  101.      If you have any suggestions, feel free to let me know. I  am
  102. also  a SmartNet Node and can be left msgs in the SysOps  confer-
  103. ence.
  104.  
  105.  
  106. CHANGES:
  107.  
  108. 04/24/91    Version 1.1
  109.         This program had originally been hard-coded for my BBS
  110. setup. There was a condition in the program that wanted to go
  111. through all of my 18 DIRectory files. For people with less than
  112. 18 directories, it would create the remaining DIRectories up to
  113. 18 with blank fields. If you had more than 18, it would probably
  114. have stopped at 18. FIXED
  115.         The other problem found was truncating the 1st character
  116. off the DIR Description of each DIR. FIXED
  117.  
  118. 04/25/91    Version 1.2 <file now called PCBDIRSB.ZIP>
  119.         There was some redundant code in the program left from
  120. my hard-coded version removed.
  121.         The PCBDIRSZ.CFG file now only requires the 1st line
  122. that tells the program where to find the DIR.LST file. On my
  123. BBS, it has D:\PCB\GEN\DIR.LST.
  124.         If you want to exclude any DIR file from being reported,
  125. they will need to be listed after the 1st line of the .CFG file.
  126. Just put the DIRxx on each line.
  127. Example: to exclude DIR2 and DIR18, you will have two lines added:
  128. DIR2
  129. DIR18
  130.  
  131. 05/02/91    Version 1.3 < file now called PCBDIRSC.ZIP>
  132.         The program was only checking .EXE and .ZIP files to be
  133. counted. That was all that I allowed on my board. It now will
  134. count those two plus LZH, GIF, ARC, COM, PAK, and PCX files. If
  135. there are others to be considered, please let me know
  136.  
  137. 05/05/91    Version 1.4 < file now called PCBDIRSD.ZIP>
  138.         If a DIRxx file was to be excluded, it was still going
  139. through the file although it would properly bypass it. FIXED.
  140.         If a DIRxx file had SORT set to 0, it was somehow dropping
  141. the next character off each following DIR information. Unknown
  142. reason, but kludge fix was incorporated to correct it.
  143.  
  144. 05/15/92    Version 1.5 < file now called PCBDIR15.ZIP>
  145.         Minor change by adding PCBoard @ANSI color codes.
  146.